home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / pack / ppcompress095.lha / ppcompress.doc < prev    next >
Text File  |  1992-11-14  |  4KB  |  133 lines
  1. PPCompress (1)           LOCAL COMMANDS            PPCompress (1)
  2.  
  3.  
  4.  
  5. NAME    NAME  
  6.      ppcompress,  ppuncompress,  ppcat - compress and expand
  7.      data 
  8.  
  9. SYNOPSIS    SYNOPSIS  
  10.      ppcompress  [ -p 0|1 ] [ -e f|m|g|v|b ] 
  11.                  [ -b s|m|l ] [ name ... ] 
  12.      ppuncompress  [ -p 0|1 ] [ name ... ] 
  13.      ppcat  [ name ... ] 
  14.  
  15. DESCRIPTION    DESCRIPTION  
  16.      PPCompress reduces the size of the  named  files  using
  17.      the  PowerPacker  compression scheme, available through
  18.      the powerpacker.library.  PPCompress takes one or  more
  19.      files  as input, compressing each in turn and saving it
  20.      according to the -p option.  If -p1 is used, the output 
  21.      file will be named by appending the suffix ".pp" to the 
  22.      input file name, and the input file  will  be  deleted.
  23.      If  -p0  is used, the input file will be overwritten by
  24.      the output.  
  25.  
  26.      The -e  option  defines  the  crunching  efficiency  of
  27.      PPCompress:  f,  m,  g,  v,  and  b  stand  for "fast",
  28.      "mediocre",   "good",   "very   good",   and    "best",
  29.      respectively.   As you move up the scale toward "best",
  30.      data is compressed more tightly, but takes longer to be 
  31.      crunched or decrunched.  
  32.  
  33.      The -b option specifies the amount of memory  used  for
  34.      crunching.   The  arguments s, m, and l demand a buffer
  35.      of "small", "medium", and "large"  size,  respectively.
  36.      The  buffer  size  is  propagated inside the compressed
  37.      file to PPUnCompress.  
  38.  
  39.      PPUnCompress expands a PPCompressed file  back  to  its
  40.      original state.    If  filename  is  not found,
  41.      PPUnCompress    attempts    to    open     the     file
  42.      filename.pp. If this fails, the user is alerted 
  43.      and no  action  is  taken.    If a file is found, it is
  44.      decrunched  and   saved   with   the   same   name   as
  45.      filename,   but   with   any   ".pp"  extension
  46.      removed.  
  47.  
  48.      PPCat  expands  a  PPCompressed   file,   dumping   the
  49.      uncompressed data to standard output.  This can be used 
  50.      to  write  the  uncompressed data to some other file or
  51.      device, as in 
  52.  
  53.           ppcat speech.pp >Hamlet.lines 
  54.      or 
  55.           ppcat speech.pp >SPEAK: 
  56.  
  57.      or to  feed  the  data  into  another  command's  input
  58.      stream, as in 
  59.  
  60.           ppcat gcc.tar.pp | tar xf - 
  61.  
  62.  
  63.  
  64.  
  65. 5 November 1992          AmigaDOS local                         1
  66.  
  67. PPCompress (1)           LOCAL COMMANDS            PPCompress (1)
  68.  
  69.  
  70.      PPCompress,  PPUnCompress,  and  PPCat can also work on
  71.      standard input or through pipes.  If input  is  through
  72.      stdin  or  a pipe, any of the programs will send output
  73.      to stdout.  This means that, when used  with  stdin  or
  74.      pipes, PPUnCompress and PPCat are identical.  
  75.  
  76.      PPCompress,  PPUnCompress,  and  PPCat  require  v35 or
  77.      greater of powerpacker.library in the libs:  directory,
  78.      or preloaded into the resident library list.  
  79.  
  80.      PPCompress,   PPUnCompress,  and  PPCat  are  the  same
  81.      program.  The operation of this program  is  determined
  82.      by the  name  by which the command was called.  It must
  83.      be one of "ppcompress", "ppuncompress", or  "ppcat"  to
  84.      be functional.  Users of AmigaDOS 2.0 or higher can use 
  85.      this   feature   to  save  space  on  disk  by  causing
  86.      "ppcompress" to be the actual program, and making  soft
  87.      links to that file from "ppuncompress" and "ppcat".  
  88.  
  89. SEE ALSO    SEE ALSO  
  90.      compress(1), powerpacker.library(3) 
  91.  
  92. BUGS    BUGS  
  93.      No true  bugs  known  at  this  point.    Note that for
  94.      maximum portability between machines, the option  "-bs"
  95.      should  be  used; however, any Amiga with a significant
  96.      portion of its RAM free and contiguous should  be  able
  97.      to handle larger buffers.  
  98.  
  99. AUTHOR    AUTHOR  
  100.      David Champion 
  101.      Internet e-mail: dgc3@midway.uchicago.edu 
  102.  
  103.      PowerPacker.library by Nico François 
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. 5 November 1992          AmigaDOS local                         2
  132.  
  133.